home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / login.man < prev    next >
Encoding:
Text File  |  1989-04-08  |  2.5 KB  |  60 lines
  1. ' $Header: /a/newcmds/login/RCS/login.man,v 1.4 89/04/07 18:43:21 douglis Exp $ SPRITE (Berkeley)
  2. .so \*(]ltmac.sprite
  3. .HS LOGIN cmds
  4. .BS
  5. .SH NAME
  6. login \- Allow a user to login
  7. .SH SYNOPSIS
  8. \fBlogin\fR [\fIoptions\fR] [\fIuser\fR]
  9. .SH OPTIONS
  10. .IP "\fB\-help\fR" 15
  11. Print a summary of the command-line options and exit without
  12. performing any logins.
  13. .IP "\fB\-l\fR"
  14. Don't record information about the user in a file of logins.
  15. The default is to record the login and logout in a file
  16. of logins used by programs like \fBfinger\fR.
  17. .IP "\fB\-P \fIportNum\fR"
  18. Use \fIportNum\fR as the port number associated with this login in
  19. the file of logins (ignored if the \fB\-l\fR option is given).
  20. .IP "\fB\-r\f"
  21. Repeat:  when a login shell exits, prompt for another account and
  22. password, and start another login shell.  The default is for \fBlogin\fR
  23. to exit as soon as its login shell exits.
  24. .IP "\fB\-d \fIdevice\fR"
  25. Use \fIdevice\fR for the login rather than the current tty.
  26. .BE
  27.  
  28. .SH DESCRIPTION
  29. .PP
  30. If an extra argument is given, \fBlogin\fR uses that name as the name
  31. of the user to log in.  Otherwise, it prompts for an account name.  In
  32. either case, \fBlogin\fR prompts for a password.  If the
  33. password matches the account, the user is logged in and a command
  34. shell is run for the user.  Information about the account, password,
  35. home directory, and login shell is taken from \fB/etc/passwd\fR.  If
  36. the password does not match the account, or the account doesn't exist,
  37. \fBlogin\fR will prompt for a new account and password.  
  38. .PP
  39. If \fIdevice\fR is given, then \fBlogin\fR attempts to use it for the
  40. standard input, standard output, and standard error channels
  41. associated with the login.  If no \fIdevice\fR is given, then \fBlogin\fR
  42. uses the standard I/O channels provided to it by the shell.
  43. .PP
  44. Normally, \fBlogin\fR waits for the login shell to exit, which signals
  45. the end of the login session, and then \fBlogin\fR exits.  If, however,
  46. the \fB\-r\fR switch is given, then \fBlogin\fR will repeat itself, asking
  47. for another account and password, and running another login shell.
  48. This will repeat indefinitely.  If the repeat switch is not given,
  49. logins will time out after 60 seconds if they are not completed.
  50. .PP
  51. If the \fB\-l\fR switch isn't given, then \fBlogin\fR will record information
  52. about the login and logout in a file for use by programs like Finger.
  53. The \fB\-P\fR switch is used to indicate which of several ports to
  54. associate with the login.  If \fB\-l\fR is given, then no login information
  55. is recorded.
  56. .PP
  57.  
  58. .SH KEYWORDS
  59. account, login, password, user
  60.